home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 26
/
Cream of the Crop 26.iso
/
bbs
/
mxgui203.zip
/
MXGUI203.DOC
< prev
next >
Wrap
Text File
|
1997-08-16
|
14KB
|
259 lines
╔═════════════════════════════════════════════════════════════════════════════╗
║ FIRST THINGS FIRST - READ THE FILE WARNING.TXT BEFORE PROCEEDING! ║
╚═════════════════════════════════════════════════════════════════════════════╝
┌╦══╦┐ ┌╦══╦┐ ┌╦═══╦┐
│╠══╩╗┐│╠══╩╗┐└╩═══╦┐
└╩═══╩┘└╩═══╩┘└╩═══╩┘
┌╦ ╦┐┌═╤╦╤═┐┌═╤╦╤═┐┌╔ ┌═╤╦╤═┐┌═╤╦╤═┐┌╔═══╦┐┌╔═══╦┐┌════╦┐
│║ ║│ │║│ │║│ │║ │║│ │║│ │╬══ │╬══ ┌─╔═╝─┘
└╩═══╩┘ ╧╩╧ └═╧╩╧═┘└╩═══╩┘└═╧╩╧═┘ ╧╩╧ └╩═══╩┘└╩═══╩┘└╚════┘
┌╦═══╦┐┌╦═══╦┐┌╔═══╦┐┌═╤╦╤═┐┌╦ ╦┐┌╦═══╦┐┌╦═══╦┐┌╔═══╦┐
└╩═══╦┐│║ ║││╬══ │║│ │║ ╦ ║│├╬═══╬┤│╠══╦╩┘│╬══
└╩═══╩┘└╩═══╩┘└╩ ╧╩╧ └╩═╩═╩┘└╩ ╩┘└╩ ╚═┘└╩═══╩┘ <tm>
A Subsidary Of LA-Soft
───────────────────────────────────────────────────────────────────────────────
▀▀▀ ▀▀▀ ▀▀▀▀▀ ▀▀ ▀▀
▀▀▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀
▀▀ ▀▀▀ ▀▀ ▀▀▀▀▀▀▀ ▀▀▀ ╔══ ╦═╗ ╔═╗ ╦═╗ ╦ ╦ ╦ ╔═╗ ╔═╗
▀▀ ▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ║ ╦ ╠╦╝ ╠═╣ ╠═╝ ╠═╣ ║ ║ ╚═╗
▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ╚═╝ ╩╚═ ╩ ╩ ╩ ╩ ╩ ╩ ╚═╝ ╚═╝ v2.03
───────────────────────────────────────────────────────────────────────────────
The MAX Graphics GUI kit is Copyright 1995-Current Larry L. Athey (LA-Soft).
Color Averaging procedures are courtesy of Sean Price (Rude Dog Software).
───────────────────────────────────────────────────────────────────────────────
Information Regarding MAX Graphics:
───────────────────────────────────
Notice is hereby given that the MAXscript/MAXcontrol/MAXcolor language,
and MAXterm are products of BBS Utiliteez Software and are protected by
US copyrights listed with the US Library Of Congress (1996)....
No changes, additions, subtractions, or other modifications shall be made
to MAXscript/MAXcontrol/MAXcolor language or the MAX Graphics development
kit without express written permission from Larry L. Athey, BBS Utiliteez
Software, Alliance, Nebraska, USA....
The MAXscript/MAXcontrol/MAXcolor language may be used in any BBS or Door
software 100% royalty free. You are also allowed to implement full local
graphics viewing in any BBS or Door software 100% royalty free. However,
any program that uses the MAXscript/MAXcontrol/MAXcolor language *MUST*
bear the MAX Graphics/BBS Utiliteez Software copyright notice....
Example: MAX Graphics and the MAXscript/MAXcontrol/MAXcolor language is
(C) 1995-Current * Larry L. Athey * BBS Utiliteez Software
───────────────────────────────────────────────────────────────────────────────
Special Notes:
──────────────
Unlike the majority of MAX Graphics related programs, the source code to the
MAX Graphics GUI Kit is not included...This wasn't done this way because I'm
trying to hide anything or have any secrets...This is only done this way for
the sake of preventing a standard from becoming a non-standard...
You should not use this kit until you have become familiar with TDK, and the
MAXscript/MAXcontrol/MAXcolor language...You do not have to be any kind of a
programming wizard to use this kit, but if you just dive into writing a door
with this kit and have no prior knowledge of the two, you'll most likely end
up throwing in the towel due to frustration...
───────────────────────────────────────────────────────────────────────────────
Files Included In This Archive:
───────────────────────────────
All unit files have an accompanying *.TXT file that shows the procedure and
function names...The MAX Graphics GUI Kit is also dependent on the TDK door
development kit so you will need to adjust your compiler directory settings
in order to make those units accessible by these units. As always, this kit
(just like TDK) requires Borland/Turbo Pascal v7.0...
Lastly, the MAX Graphics GUI Kit is fully dependent on the FastGraph kit by
Ted Gruber Software. You may use the full FastGraph kit, or FastGraph Light
with this kit. BBS Utiliteez Software & LA-Soft and Ted Gruber Software are
in no way connected, this kit is simply dependent on one of their kits. For
more information on FastGraph, please contact:
Ted Gruber Software
P.O. Box 13408
Las Vegas, Nevada, 89112
Voice - (702)735-1980
Fax - (702)735-4603
WWW - http://www.fastgraph.com
E-Mail - fastgraph@aol.com
Ted Gruber Software, and the shareware version of the FastGraph package has
its own policies and rules...In no way whatsoever does the freeware concept
of MAX Graphics apply to Ted Gruber Software or the FastGraph package...
This copy of The MAX Graphics GUI Kit is only designed to compile with the
unregistered shareware version of FastGraph/Light. When you have purchased
the full version of FastGraph (not FastGraph/Light), please contact me and
I will make a custom compiled version of The MAX Graphics GUI Kit for you.
If you try to compile this kit with anything but the FastGraph/Light v4.04
shareware archive, you will end up with up with unit version mismatches...
You may freq the magic name "FASTGRAPH" from 1:14/703 for the most current
FastGraph/Light shareware archive if you do not have internet access...
_SCRIPT.TPU - This is the MAXscript/MAXcontrol/MAXcolor interpreter unit
that parses MAX commands and turns them into local graphics.
GUI_ANSI.TPU - This is the SVGA ANSI emulation unit used for text view ports
GUI_ANSI.TXT and regular graphical ANSI emulation in MAXterm.
GUI_FONT.TPU - This is the GEM font support unit.
GUI_FONT.TXT
GUI_ICON.TPU - This is the MAX Graphics icon support unit.
GUI_ICON.TXT
GUI_IMAG.TPU - This is the PCX/BMP/MIF/FLI image support unit. If you want
GUI_IMAG.TXT to support MIF images in your programs, the MIF.EXE program
will need to be distributed with your programs.
GUI_MOUS.TPU - This is the main mouse support unit.
GUI_MOUS.TXT
GUI_UNIT.TPU - This is the meat and potatos of the MAX Graphics GUI Kit,
GUI_UNIT.TXT this unit contains the main system procedures/functions
as well as all of the GUI specific variables/records.
GUI_UTIL.TPU - This is the utility unit, this unit contains all of the
GUI_UTIL.TXT string/number/file handling procedures/functions.
MAINMENU.MAX - This is an external MAX screen file which is used by the
the example MAX door program.
MAXDOOR.EXE - This is a sample door program that can be compiled to use
MAXDOOR.PAS local SVGA graphics and no communications routines, or it
MAXDOOR.INC can be compiled the other way with no local SVGA graphics
and communications routines.
MAXSOUND.EXE - This is the MAX Graphics sound file player program. This is
intentionally made an external program because the buffers
used to play the sound files kills the program data segment,
even if they are NEW'ed/DISPOSE'd in pointer arrays. Aren't
real mode programs a peach to deal with? :)
MAXUNITG.PAS - This is a dummy unit to handle the procedures and functions
that would normally be handled by the TDK units: MAX_UNIT,
DOORKIT1, and DOORKIT3. The concept behind the MAX Graphics
GUI Kit is that you comment out the three units listed in
the above and place this unit at the end of the USES clause
of your main program/units. This way you can write the SVGA
side to your doors in local graphics mode, and when they're
fully debugged, you then comment out this unit and uncomment
the other units. Recompile the program with the TDK units
back in place and you'll have a fully functional MAX'ed out
door. Depending on how you write your doors, you may have to
modify this unit, therefore the source code is included...
MIF.EXE - As with the MAXSOUND.EXE program, this program is also made
external for the same reasons. This program is used to read
a *.MIF image file and decompress it into readable data.
SYSTEM.OBJ - These are font object files used for MAX font types 1 & 2.
BIT5X8.OBJ These files are automatically linked into your code when
you compile the program so you never have to included the
files with your programs. MAX font type 3 is derived from
the ROM, so no external font object file is needed for it.
PALETTE.DAT - This is the MAX Graphics color palette settings file. This
is used to set the video DACs when the SVGA mode fires up.
If you distribute any programs that run in SVGA mode, you
will need to include this file with every program archive.
───────────────────────────────────────────────────────────────────────────────
System Preparation:
───────────────────
After you have installed TDK, FastGraph, and The MAX Graphics GUI Kit, you
will need to designate a directory to use as a "Session Path" and put all
of your resource files there. The default path for this is \SESSION\ which
is immediately below your main program directory. However, you can change
this to any path that you choose by modifying the initialization portion
of MAXUNITG. This unit is just set up so that it uses the same directories
as MAXterm does. In this session path, you will need to at least have the
bare minimum of the ICON_LIB.* libraries from MAXterm's DEFAULT.PKG, just
PKUNZIP this file to your session path and that's all you'll need. You can
add more resources later on as necessary...
You may also specify a session path on the command line. The existence of
this path as well as the existence of the default MAX icon libraries will
be checked at start up time...If any of these items don't exist, the door
will exit with an error message on the screen...
If you are using Turbo Pascal v7.0 and experience "Out Of Memory" errors
when compiling a local SVGA MAX door, you may want to consider upgrading
to Borland Pascal With Objects v7.0 instead...The problem with the Turbo
Pascal package is that the IDE and compiler are "Real Mode" programs and
BP7.0 uses a "Protected Mode" IDE and compiler. The BP7.0 protected mode
IDE and compiler uses all of your memory rather than just your remaining
conventional memory. Upgrading to BP7.0 definitely has its benefits, and
will allow you to compile much larger programs...
───────────────────────────────────────────────────────────────────────────────
How It All Works:
─────────────────
As mentioned in the file descriptions in the above, the MAXUNITG.PAS unit
is used to simulate procedures and functions in DOORKIT1.PAS, DOORKIT3.PAS
and MAX_UNIT.PAS...Since you are writing a door with MAX Graphics support,
you will need a way of testing things without the need to call in to your
BBS with MAXterm. That's exactly what this kit allows you to do. You just
modify your main program and all units and comment out references to the
DOORKIT1.PAS, DOORKIT3.PAS and MAX_UNIT.PAS units, then at the tail end of
the USES clause you add a unit reference to MAXUNITG. Recompile your door
and when it starts up, it will automatically be running in SVGA mode with
the Graphics variable set to MAX. You will now see everything exactly the
same way that a MAXterm caller will see it...
Keep in mind that you should NEVER under any circumstances try to compile
and run a door with DOORKIT1, DOORKIT3, MAX_UNIT, and MAXUNITG together!!
Your door will not run, and you will most likely end up with a locked up
computer. MAXUNITG is only intended for testing purposes, your doors can
only have comm routines with no SVGA, or SVGA with no comm routines, this
is critical!!
As you can see by the USES clause in MAXDOOR.PAS, the only units used by
the program when in SVGA mode are DOORKIT2.PAS and TDK_VARS.PAS, none of
the other TDK units are used. You will also notice by running the door
that it doesn't support the normal command line parameters in TDK, nor
does this door support any of the sysop F-Keys. Since this is a "Local
Only" door, there is no need for any of this other stuff. Not even the
node control file is read when running the door, all of this is taken
care of in the initialization portion of the MAXUNITG.PAS unit. You will
need to change these variables to suit your needs if the default settings
are not desired...
After you have debugged the MAX side of your door, simply comment out the
MAXUNITG.PAS unit, and uncomment the other units you previously removed.
Recompile your door and that's all there is to it, it's just too simple...
───────────────────────────────────────────────────────────────────────────────
Important Note About Sound Support:
───────────────────────────────────
Be absolutely sure that you adjust the variables in the initialization
portion of MAXUNITG.PAS to match your existing SoundBlaster settings, or
else you will lock up your computer as soon as you attempt to play any
sound files. If you don't have a SoundBlaster installed, you will want
to copy the file MIF.EXE over top of the file MAXSOUND.EXE...
───────────────────────────────────────────────────────────────────────────────
For an authentic copy of this program, see below:
┌───────────────────────────────────────────────────────────────────┐
│ Contact: 1:14/703@FidoNet Or: USA MAX Graphics HQ-BBS │
│ 411:1500/0@ivNET (308)762-2239 │
│ 121:101/2@AllianceNet FAX or Data Calls │
│ maxgfx@juno.com ANSI/ASCII/MAX (No RIP) │
└───────────────────────────────────────────────────────────────────┘